home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / perfTuning / gldebug.man < prev    next >
Text File  |  1994-08-01  |  3KB  |  88 lines
  1.  
  2. GLDEBUG(1)                                                          GLDEBUG(1)
  3.  
  4. NAME
  5.      gldebug - debug utility for GL programs
  6.  
  7. SYNOPSIS
  8.      gldebug [-hwef] [-cs] [-C] [-F] [-p wait] [-i filename] [-o filename]
  9.      [-O] application [ -application options ]
  10.  
  11. DESCRIPTION
  12.      gldebug is an aid for debugging GL programs.  It outputs a trace of GL
  13.      functions and parameters invoked by the program, and performs run-time GL
  14.      error checking of parameters and state, to ensure that the GL is being
  15.      called by the application properly.
  16.  
  17.      Also provided with gldebug are a Stateviewer and a Controller.  The
  18.      Stateviewer graphically displays the current state of the GL as the
  19.      application is running. The Controller allows the user to interactively
  20.      change the level of debugging output, as well as set breakpoints to stop
  21.      execution at GL calls or at error conditions.
  22.  
  23. OPTIONS
  24.      -h              no history output.
  25.  
  26.      -w              no warning output.
  27.  
  28.      -e              no error output.
  29.  
  30.      -f              no fatal error output.
  31.  
  32.      -c              do not run Controller.
  33.  
  34.      -s              do not run Stateviewer.
  35.  
  36.      -C              generate C code in history file.
  37.  
  38.      -F              flush output buffer to history file after each GL call.
  39.  
  40.      -p wait         profile (output the number of times each GL function is
  41.                      called).  wait is the number of GL calls wait between
  42.                      each profile write to file.  Profile output goes to
  43.                      GLdebug.count.
  44.  
  45.      -i filename     ignore the GL functions listed in filename when writing
  46.                      output.  filename should contain GL function names listed
  47.                      one per line.
  48.  
  49.      -o filename     send history trace output to filename. Default is
  50.                      GLdebug.history.
  51.  
  52.      -O              send history trace output to stdout. This overrides -o
  53.                      filename.
  54.  
  55.                                                                         Page 1
  56.  
  57. GLDEBUG(1)                                                          GLDEBUG(1)
  58.  
  59. FILES
  60.      /usr/lib/libgd.so        gldebug dynamic shared object
  61.  
  62.      /usr/sbin/gldebug        executable
  63.  
  64.      /usr/sbin/gd_controller  the Controller executable
  65.  
  66.      /usr/sbin/gd_stateview   the Stateviewer executable
  67.  
  68.      /usr/lib/X11/app-defaults/GLdebug
  69.                               the X application defaults for the controller
  70.                               and stateviewer.
  71.  
  72. NOTES
  73.      A program must have been linked with the GL dynamic shared object (DSO),
  74.      IRIX release 5.0 or later, to work with gldebug.  A program linked with
  75.      the shared GL library (-lgl_s), available with previous releases of the
  76.      operating system, will not work with gldebug.
  77.  
  78.      The stateviewer will be disabled when running gldebug on a program that
  79.      is displaying windows on a remote system (ie. the DISPLAY environment
  80.      variable is set to a system other than that which is running the program
  81.      itself).  In this case, a warning message will appear in a menu to
  82.      explain the stateviewer's absence.
  83.  
  84. SEE ALSO
  85.      GL Programming Tools and Techniques, GLdebug chapter
  86.  
  87.                                                                         Page 2
  88.